LocalConnection.send()

Доступность

Flash Player 6.

Синтаксис

sending_lc.send (connectionName:String, method:String [, p1,...,pN]) : Boolean

Параметры

connectionName Строка, соответствующая имени соединения, переданого в качестве параметра методу LocalConnection.connect() объекта-получателя, который будет взаимодействовать с sending_lc

method Строка, соответствующая имени метода, который необходимо вызвать у объекта-получателя. Следующие имена методов использовать нельзя: send, connect, close, domain, onStatus и allowDomain.

p1,...pN Необязательные параметры, которые необходимо передать вызываемому методу.

Возвращает

Булева величина: true, если Flash может передать запрос (запрос корректен); false в противном случае.

Замечание: возвращаемое значение true вовсе не означает, что Flash успешно произвела подключение к объекту-получателю; это значит лишь то, что вызов будет синтаксически корректным и не вызовет конфликтов. Как определить, было ли соединение успешным, смотри LocalConnection.onStatus.

Описание

Метод; вызывает метод method по соединению, открытому методом LocalConnection.connect(connectionName) объекта-получателя. Объект, использующий данный метод, называется объектом-отправителем. Объект-получатель и объект-отправитель должны быть запущены на одном компьютере.

Существует ограничение на размер данных, которые Вы можете передать данному методу в качестве параметров. Если метод возвращает false, но Ваш синтаксис верен, попробуйте разбить запрос, передаваемый LocalConnection.send() на несколько частей.

Как ранее упоминалось в статье LocalConnection.connect(), Flash по умолчанию добавляет префикс над-домена к connectionName. Если Вы реализуете взаимодействие между файлами в разных доменах, Вам необходимо определить connectionName в обоих объектах так, чтобы Flash не добавлял префикс над-домена к connectionName. Это возможно в двух случаях:

Замечание: Вы не можете определить над-домен в имени соединения connectionName в объекте-приемнике — это возможно только в случае с объектом-отправителем.

Пример

Для примера взаимодействия между объектами LocalConnection, расположенными в одном домене, смотри LocalConnection.connect(). Пример взаимодействия между объектами из разных доменов вы найдете в статье LocalConnection.allowDomain, равно как и пример для взаимодействия объектов из строго определенных доменов.

См. также

LocalConnection.allowDomain, LocalConnection.connect(), LocalConnection.domain(), LocalConnection.onStatus